OpenEdge Development:<br />Progress 4GL Reference FRAME-FIELD function

Release 10.1A: OpenEdge Development:
Progress 4GL Reference

FRAME-FIELD function

During a data entry statement, returns the name of the input field the cursor is in. At other times, returns the name of the input field the cursor was last in.

The FRAME-FIELD function is particularly useful if you want to provide the user with help for the input field being used.
Note: Does not apply to SpeedScript programming.

Syntax
FRAME-FIELD 
Example

For each field the user is updating, this procedure displays the name of the field, the table the field belongs to, and the value currently in the field. The EDITING phrase is part of the UPDATE statement; it displays information on the field as the user updates the record, and then reads each of the keystrokes entered (READKEY) and applies those keystrokes (APPLY LASTKEY).
r-frfld.p
FOR EACH customer:
    UPDATE cust-num name address address2 city state postal-code
         WITH 1 DOWN 1 COLUMN CENTERED
   EDITING:
      DISPLAY "You are editing field:" FRAME-FIELD SKIP
              "Of file:" FRAME-FILE SKIP
              "Its value is:" FRAME-VALUE FORMAT "x(20)"
              WITH FRAME a ROW 15 NO-LABELS CENTERED.
      READKEY.
      APPLY LASTKEY.
   END. /* Editing */
END. 
Notes

If the current or last input field is an array, FRAME-FIELD returns the name of the field but does not indicate the array element that the input field represents. To display the array element, use the FRAME-INDEX function.

If the cursor was not in an enabled input field when the last input statement ended, FRAME-FIELD returns an empty string.

See also

FRAME-FILE function, FRAME-INDEX function, FRAME-VALUE function, PROGRAM-NAME function